home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 22
/
Cream of the Crop 22.iso
/
editor
/
lc_120.zip
/
LIGHTCHT.ZIP
/
LIGHTCHT.DOC
< prev
next >
Wrap
Text File
|
1996-09-13
|
136KB
|
3,671 lines
█
█
█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█▀▀▀▀▀▀
█ █
█ ▄ ▄ ▄ ▄ █
█ ▀ ▄▀▀▀▄ █ █ ▄▀▀▀▄ █ █ ▄▀▄ █
█ ▀█ █ █ █ █ █ █ █ █ █
█ █ █ ▀▀█ █▀▀▀█ ▀▀█▀▀ █ █▀▀▀█ █▀▀▀█ █
█ ▄█▄ ▀▄▄▄▀ █ █ █ ▀▄▄▄▀ █ █ █ █ █
█ █ █ █ █ █ █
█
█
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
LightChat v1.20
"The brightest chat program ever!"
Copyright (C) 1994-1996 Lightning Systems
All Rights Reserved
│ ─────────┬─
│iG├┤┬ C├┤A│
└────────────
USER GUIDE
Table of Contents
1 INTRODUCTION .................................................. 4
1.1 What is LightChat? ....................................... 4
1.2 Features ................................................. 4
1.3 License Agreement and Disclaimer ......................... 8
1.4 Users' Comments .......................................... 9
1.5 Registration ............................................. 9
2 INSTALLATION ................................................. 10
2.1 Unpacking the Files ..................................... 10
2.2 Using AutoInstall ....................................... 10
2.3 Configuring Your BBS Software for LightChat ............. 13
2.3.1 Configuring RemoteAccess or ProBoard ............. 13
2.3.1.1 Creating a 'Page SysOp' Option .......... 13
2.3.1.2 Configuring RA/PB to Break into Chat .... 14
2.3.2 Configuring Other BBS Software ................... 15
2.4 Configuring Your BBS Software for LightEdit ............. 16
2.4.1 Configuring RemoteAccess or ProBoard ............. 16
2.4.2 Configuring Other BBS Software ................... 17
3 LCSETUP ...................................................... 18
3.1 System .................................................. 18
3.1.1 Names ............................................ 18
3.1.2 Paths ............................................ 19
3.1.3 Filenames ........................................ 20
3.1.4 Paging ........................................... 23
3.1.4.1 General ................................. 23
3.1.4.2 Display ................................. 25
3.1.4.3 Hours ................................... 26
3.1.4.4 Reason for chat ......................... 26
3.1.5 General .......................................... 27
3.1.5.1 Random ANSI effects ..................... 27
3.1.6 Strings .......................................... 29
3.1.6.1 Auto greetings .......................... 29
3.1.6.2 Auto goodbyes ........................... 31
3.2 Chat Keys ............................................... 33
3.3 Word Macros ............................................. 33
3.4 Chat Mode Manager ....................................... 34
3.4.1 Editing chat modes ............................... 35
3.5 Language Manager ........................................ 38
3.5.1 Editing languages ................................ 39
3.5.2 Customising languages ............................ 40
3.6 Message Editor .......................................... 41
3.6.1 General .......................................... 41
3.6.2 Conditions ....................................... 43
3.6.3 Screen ........................................... 44
3.6.4 Editor keys ...................................... 46
3.7 Registration ............................................ 47
3.8 Information ............................................. 47
3.9 Exit to DOS ............................................. 47
4 LIGHTCHT ..................................................... 48
4.1 Command line parameters ................................. 48
4.2 Operation ............................................... 49
4.2.1 Paging ........................................... 49
4.2.2 Intelligent "logon" mode ......................... 49
4.2.3 Using AutoExclude ................................ 50
4.2.4 Customising screens .............................. 51
4.2.5 Default Operation and Keys ....................... 52
5 APPENDICES ................................................... 56
5.1 Data codes .............................................. 56
5.2 Key functions ........................................... 57
5.3 Embedded program codes .................................. 60
5.4 Errorlevels ............................................. 61
6 CREDITS ...................................................... 62
7 SUPPORT AND INFORMATION ...................................... 63
1 Introduction
Welcome to LightChat, probably the most sophisticated and
configurable chat program ever written!
This introduction describes exactly what LightChat is, provides a
list of its extensive features, and gives details of how you can
register.
If you have not used LightChat before, we recommend you read the
rest of this introduction to find out more about what LightChat can
do, and then refer to Section 2 for full details on how to set up
LightChat for your system.
1.1 What is LightChat?
LightChat is a sophisticated and stylish split-screen multi-node
aware chat program. It can be used with any BBS that supports the
DOOR.SYS drop file format, and has extra facilities if you are using
RemoteAccess or ProBoard. Every effort has gone into LightChat, in
an ultimate aim to make it the best chat program on the market.
LightChat's sheer configurability and rich feature set make it stand
out from the crowd. You will also find LightChat is one the easiest
programs you have ever installed, thanks to its intelligent
AutoInstall technology. Coupled with Lightning Systems' continued
commitment to providing a quality service, you really can not go
wrong.
We truly believe that this is the best BBS chat program money can
buy. If, after trying it, you disagree, we would sincerely
appreciate your comments and/or suggestions as they are very useful
for future releases.
LightChat now consists of TWO programs in one! LightChat has a
special feature whereby you can tell it to act as an external
message editor - a single switch and LightChat is now "LightEdit"!
1.2 Features
As you can see from the list below, LightChat is already packed with
features, but we are regularly receiving requests from users for
additional features that we hadn't thought of. If you have a
suggestion, get in touch - it may well be included in the next
version! Details of how to contact us can be found in Section 7.
In the following list of features, those that are marked with {+}
are only available in the registered version.
* Intelligent interactive AutoInstall feature, with complete
self-installation in seconds!
* Fully backward-compatible with previous versions of LightChat.
LCSETUP can import and set defaults for ANY previous release.
4
* Demo mode with demonstration of features and a guided tour when
run in local mode.
* Customisable ASCII chat mode:
- Customisable text file to display upon entry.
- Configurable colours for SysOp and User text.
* Up to 255 fully configurable ANSI chat modes. {+}
- Configurable colours.
- Configurable window sizes/positions.
- Configurable date/clock type, colours and positions.
- Configurable screen layout.
- Configurable 'scrollback' buffer.
- Configurable 'number of lines to scroll'.
* Chat Mode Manager, allowing you to add/delete/move/search/disable
chat modes, and move clock/window positions etc. around the
screen using cursor keys, eliminating the need to remember
coordinates.
* Language Manager, allowing you to define up to 255 different
languages, and configure contents and colour of every line of
text LightChat sends to the user. LightChat languages are
matched against user's language (RemoteAccess only), and used in
preference to configurable default language.
* Ability to override default textfile path with language specific
path, so that each language can have a different set of screens.
* Command line controlled chat mode selection (forced, or random
choice).
* Configurable random ANSI effects when loading LightChat.
* Intelligent "Logon" mode, invoked by LightChat when it
autodetects that a user is still in the new user or logon
procedure.
* Parameters can be obtained from DOOR.SYS file or overridden by
optional command line parameters.
* Configurable 'reason for chat' screen, with reason for chat
returned to RemoteAccess' status bar. {+}
* Customisable automatic greetings and goodbyes, with random/time
control and configurable SimuType technology (simulated typing).
* Configurable intelligent auto-greeting, to prevent greeting a
user more than once during the same call. {+}
5
* Configurable pager:
- Beep, tune, soundcard or silent operation.
- Configurable 'bar graph' page progress indicator.
- Configurable page duration.
- Random tune selector feature.
- Configurable paging hours in 1/2 hour blocks.
- Silence button (SCROLL LOCK).
- Configurable maximum number of pages per call.
- AutoExclude facility, for automatically barring pest-users. {+}
- Flashing keyboard lights (configurable) in time to the page
tunes!
* Support for soundcards (SB/SB Pro/SB16/GUS/Ensoniq), and ability
to play soundtracker modules as page tunes.
* Ability to record and monitor periods of low, medium and high
demand from users. {+}
* Fully configurable message-to-SysOp feature, with support for
Hudson and JAM message base types.
* Built-in ANSI message editor with full text-editing facilities.
* Direct-save feature in message editor.
* Page up/down, delete line, insert/overtype, backspace/delete,
full cursor movement facilities within all chat modes and messages
editor.
* Message editor can be used as a stand-alone external
QuickBBS-compatible message editor, with full editing facilities,
including quote window.
* Built-in RemoteAccess-style ASCII message editor.
* Shell to DOS facility, with customisable user-messages, and
swapping to EMS, XMS or Disk.
* All user selections/choices are made with colour-configurable
hotkey/cursor driven LightBars, with animated ANSI prompts.
LightBar text can be changed for each language.
* Up to 3 additional names to use instead of SysOp's name, each
with an associated (configurable) chat key to answer page.
* Definable keys and associated functions (50 for the SysOp, 50 for
the user). ALL keys for any function in LightChat are completely
configurable! Separate key sets for LightChat and LightEdit.
Defined keys are available at all times during program operation.
* Definable word-macros, with user/SysOp/both, SimuType and case
sensitivity control mechanism.
* Configurable trigger characters to activate word-macros.
6
* Ability to run external programs from within LightChat, and swap
out to EMS/XMS/Disk to minimize memory usage.
* Editor-like chat windows, with full cursor movement and text
insertion/deletion, both locally and remotely.
* Text in chat windows is deletable in both directions (i.e. you
can delete characters to the right of the cursor as well as to
the left).
* Delete-line feature, in both chat and message editor.
* Complete internal user editor, with customisable user-messages
and on-line help.
* Ability to swap to the other chat window.
* Ability to freeze the user's input.
* Hang-up facility, to disconnect user directly.
* Lock-out facility, to lock out user directly.
* Chat capture-to-file facility with configurable multi-node aware
capture filename.
* Chat capture stores both SysOp and user input separately.
* Auto chat capture feature, with automatic re-opening after
mode-switch.
* Allows "high-ASCII" in chat and all configurable strings; useful
for international characters.
* Redraw screen facility.
* Clear window/other window feature.
* Multi-node aware.
* Supports DOS, OS/2, Windows, Windows 95 and DESQview, and
releases timeslices where appropriate, for smooth operation.
* Configurable action if the SysOp is already chatting to another
user.
* Customisable .ASC/.ANS files to display when:
- Asking for a reason for chat. {+}
- The reason given is too short.
- Paging the SysOp.
- The SysOp aborts the page.
- The SysOp does not answer the page.
- The SysOp is already chatting to another user.
- The user not allowed to page the SysOp.
- The user is paging outside of paging hours.
7
* Excluded user list to prevent particular users from paging the
SysOp.
* Configurable action when dealing with excluded users - either
display a file or 'pretend' to page the SysOp.
* USERDOES support for compatible programs to show that the user is
in LightChat.
* Configurable USERDOES and semaphore paths.
* USERDOES file shows when the user is paging, when they are
chatting, and when leaving a message.
* LightChat activates/deactivates RemoteAccess' 'wants chat'
indicator.
* Sets RemoteAccess to show 'SysOp Chat' from a 'Who's on-line?'
menu option.
* 'Rotatable' SysOp status bar, with configurable colours.
* RemoteAccess style compact or expanded logging.
* Returns specific errorlevels indicating user's behaviour, system
errors, etc.
* Interactive and easy to use configuration program, complete with
context-sensitive on-line manual.
1.3 License Agreement and Disclaimer
"Lightning Systems" consists of David McGarry and Marcel Cook.
"LightChat" refers to the executables and documentation contained in
the LightChat distribution archive, officially released by Lightning
Systems.
* LightChat is Copyright (C) 1994-1996 Lightning Systems; All
rights reserved.
* Lightning Systems and the author(s) of LightChat are under no
obligation to provide future versions of, or support for
LightChat.
* Lightning Systems and the author(s) of LightChat will under no
circumstances be held responsible for any damage or loss
resulting from the use or misuse of LightChat.
* By using LightChat you are agreeing to the conditions set out in
this License Agreement and are therefore releasing Lightning
Systems and the author(s) of LightChat from any liability or
litigation.
8
1.4 Users' Comments
You don't have to take our word for it - here is what some SysOps
who already use LightChat have had to say about it:
"It is the most impressive chat software I have ever come across."
Les Pitcher, Phantasmagoria BBS (2:2503/413)
"It's a truly excellent program."
Glen Chambers, The Glass Asylum (2:257/84)
"Oi! Oi! Oi! Gimme Gimme Gimme! :-)"
Michael Rallings, Gunsmoke BBS (2:252/174)
These are comments we have received from genuine SysOps (printed
with their consent) who use LightChat on a daily basis.
1.5 Registration
This software is not free. The unregistered version is distributed
for evaluation purposes and as such, you are expected to register it
after an initial evaluation period of 30 days. If, after this
period, you decide not to use the software, you must not use it
again without registering first.
What you get by registering:
* No more annoying flashing UNREGISTERED signs (and also silent
operation).
* Ability to define your own 'reason for chat' prompt screen.
* Forced/random chat mode selection.
* Up to 255 fully configurable chat modes.
* Ability to let the user switch chat modes and quit chat.
* Ability to suppress tearlines in messages to SysOp.
* No 'UNREGISTERED' taglines in LightEdit.
* Intelligent auto greetings.
* AutoExclude facility.
* Activity monitor, showing periods of low, medium and high demand.
* Full technical support.
* Free updates when available (no upgrade fee).
* More chance of LightChat being developed further.
The basic registration fee is currently UKP 15.00, US $25.00 or
37.00 DM. Remember, you get two programs for the price of one!
To register, please read the ORDERING.TXT file enclosed in the
official LightChat distribution archive.
┌─────────────────────────────────────────────────────────────────┐
│ You can register LightChat RIGHT NOW on CompuServe! Simply 'GO │
│ SWREG', and use the LightChat Product ID, 4832. │
└─────────────────────────────────────────────────────────────────┘
9
2 Installation
Installing LightChat is an extremely easy task, thanks to its
intelligent AutoInstall facility, which will configure LightChat for
you as much as possible, install itself into your BBS system, and
all in a matter of seconds!
LightChat requires a fossil driver to be present in your system to
run (this is not required in local mode). If you do not already
have one, you must obtain and install a fossil driver before using
LightChat. We recommend X00 or BNU, although LightChat should work
with others. Fossil drivers are available from most BBS's, but can
also be obtained from Lightning Systems or Lightning BBS.
2.1 Unpacking the Files
Make a directory to extract the LIGHTCHT.ZIP file into. For
consistency with the paths used in this documentation, we recommend
the following:
C:\RA\LIGHTCHT
With the LIGHTCHT.ZIP file inside this directory, extract it using:
PKUNZIP -D LIGHTCHT
This will ensure the creation of all the sub-directories with their
relevant files.
After unpacking the files, you should receive the following message:
Authentic files Verified! # XNT146
Marcel Cook
David McGarry, Lightning Systems
If you do not, then LIGHTCHT.ZIP is not the officially released
archive, and you should delete it and obtain a new copy.
2.2 Using AutoInstall
AutoInstall is a sophisticated self-installation system that makes
installing LightChat as quick and easy as possible.
After using the LCSETUP utility, LightChat will be fully installed
in your system, and you do not need to configure/install anything!
If you are using LightChat with BBS software other than RemoteAccess
or ProBoard, regrettably, you will not be able to use this facility,
and should refer to Section 2.3 for details of how to install
LightChat manually, and then Section 3 for configuration
instructions. Note that even if you are not using RemoteAccess,
AutoInstall will still attempt the first and last steps shown below.
10
┌────────────────────────────────────────────────────────────────────┐
│ Note: Although LightChat is fully backward-compatible (AutoInstall │
│ automatically imports old configurations), it is recommended │
│ that you completely re-install LightChat if you currently │
│ use Versions 0.28 or 0.29, in order to take full advantage │
│ of the major enhancements. │
└────────────────────────────────────────────────────────────────────┘
If you are using RemoteAccess or ProBoard, we strongly recommend you
use LightChat's AutoInstall facility for first-time installations.
This ensures LightChat's configuration is fully in-tune with your
system. AutoInstall's only requirement for successful operation is
that you set the RemoteAccess or ProBoard environment variable to
point to your BBS system directory (see your RemoteAccess/ProBoard
documentation for more details).
AutoInstall will adjust many paths and filenames according to where
LCSETUP is located when it is run. Therefore, before using
AutoInstall, you should ensure that LCSETUP is in the directory
where LightChat will finally reside.
Next, run LCSETUP. You will be prompted to create a LIGHTCHT.DAT
file, which is achieved by pressing the SPACE bar.
LCSETUP will now ask whether you would like to use AutoInstall. If,
for some reason, you do not want LCSETUP to alter your BBS
configuration and menu files (despite the fact that it will make
backup copies of everything it changes), you should press 'N'. You
will then have to configure LightChat manually, although it will
still configure the paths to the LightChat system files for you.
If you choose 'Y', LightChat's AutoInstall facility will now attempt
to achieve the following tasks:
* Locate an existing LightChat installation. If found, this
configuration will automatically be imported and converted, and
any new features will be given default values. Otherwise,
AutoInstall will continue as follows:
* Locate your RemoteAccess or ProBoard configuration files. If
found, AutoInstall will make a backup copy (CONFIG.OLD), paging
settings will be transferred to your LightChat configuration, and
the command line required to invoke LightChat will be
automatically generated and placed in your BBS configuration. You
will also be asked if you wish to configure LightChat's
"LightEdit" feature. If you choose to do so, AutoInstall will
generate a command line to invoke LightEdit, and place it in the
"External message editor" slot in your BBS configuration. If you
are using RemoteAccess, but have not yet registered, AutoInstall
will 'intelligently' select a suitable Alt-function key slot in
which to place the LightChat command line.
11
* Locate your GLOBALRA.MNU or GLOBAL.PBM menu file. If you use
such a menu on your BBS, AutoInstall will make a backup copy of
this, and install LightChat into the menu for you. AutoInstall
uses heuristics to either 'intelligently' select an existing menu
slot or create a new one. If no global menu exists, AutoInstall
will create one.
* Locate your To/From SysOp message-base. AutoInstall uses
heuristics to attempt to locate your private message-base, and if
successful, configures LightChat accordingly. If it does not
successfully choose the correct message-base, it will use its
'best guess'.
* Adjust pathnames and filenames. AutoInstall will detect where
you have extracted the LightChat files, and adjust relevant path
and file names accordingly. Therefore, it is important that the
files are located where they will be used later, when running
LCSETUP for the first time.
As you can see, AutoInstall's self-configuration is very
comprehensive, and as a result, it is unlikely that you will need to
configure anything manually before you are able to use LightChat for
the first time.
There are, however, many options in LCSETUP which you should
familiarise yourself with over time. To do this now, we suggest you
read Section 3 of this documentation. If you are keen to get
LightChat up and running, here are a few things you might wish to
check before attempting to execute LightChat:
* System->Names->SysOp's name
Your name should be entered here.
* System->Paths
Check that the paths are correct for your particular setup.
* System->Filenames
Check that the paths are correct for your particular setup. It
does not matter if some of the definable .ASC/.ANS screens are
not present at this stage of the installation procedure.
After checking these options, press the ESCAPE key to exit LCSETUP.
You will be prompted to save your changes, for which you should
answer yes by pressing the Y key.
You are now ready to add LightChat to your BBS and try it out!
If AutoInstall was successful, you should not need to configure
LightChat any further, or even install it in your BBS - you can now
try loading LightChat from DOS, or start up your BBS and try paging.
Otherwise, you will have to install and configure LightChat
manually. Please refer to the next section for details of how to
install LightChat, and then read Section 3 for configuration
details.
12
2.3 Configuring Your BBS Software For LightChat
For LightChat to be able to run, a minimum requirement is that it
has access to a DOOR.SYS BBS drop file. This file contains
essential information about the user and your system. RemoteAccess
and most other BBS software is capable of producing this file -
please refer to your BBS software documentation if you are not sure.
LightChat expects to be able to find this file in the current
directory when LightChat is loaded - if it is not, then LightChat
cannot run.
2.3.1 Configuring RemoteAccess or ProBoard
The easiest way of loading LightChat from RemoteAccess or
ProBoard is to set it up in a 'Type 7' menu option. If you use
this method, the DOOR.SYS file will already be in the current
directory when LightChat loads, so you do not need to worry
about this. If you use any other method (such as a batch
file), you will need to ensure that you change into the
directory containing the DOOR.SYS file before making the batch
file load LightChat.
LightChat can also use another fill (used by RemoteAccess,
ProBoard, and some other BBS systems), which contains
additional information about the user and your system. This
file is called EXITINFO.BBS, and will be created in the same
directory as DOOR.SYS. It is not required for LightChat to
run, but will let you use additional features such as the
rotatable status bar, the internal user-editor and the 'Wants
Chat' indicator.
2.3.1.1 Creating a 'Page SysOp' Option in a Menu
If AutoInstall was successful, it will have already
installed LightChat in a Type 7 menu option in your
global menu file, in the form shown below.
Here is how LightChat should be called from a Type 7 menu
option from RemoteAccess:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /MR /N*N /B*B /P*P *! *M
Here is how LightChat should be called from a Type 7 menu
option from ProBoard:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /MR /N*# /B*B /P*P *! *D
The /MR parameter makes LightChat randomly select a chat
mode to start in. It has no effect unless you have
registered LightChat.
13
The /N, /P, and /B parameters specify the node number,
port number, and baud rate of the caller. They are
totally optional, but are REQUIRED for the intelligent
"logon" mode (see Section 4.2.2) to function correctly.
The *! parameter freezes the BBS timer whilst you are in
chat mode, so that the user still has the same number of
minutes available on-line after finishing a chat session
as they did before they paged you.
The *M parameter forces RemoteAccess to swap out of memory
before executing LightChat, allowing LightChat to use more
memory for itself. ProBoard will always attempt to swap
out, unless you disable this in your BBS setup.
This will load LightChat and start the paging action.
2.3.1.2 Configuring RemoteAccess/ProBoard to Break into
Chat
LightChat accepts a parameter /F, which forces it to
bypass the page screen and enter chat mode immediately.
This is useful for the SysOp to initiate a conversation
with a user.
If AutoInstall was successful, this step should have
already been performed for you.
However, there are two ways you can do this yourself:
1. LightChat can be added to RACONFIG's external chat
slot. In RACONFIG, under Options->Paging->External, the
following line can be added:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /F /MR /N*N /B*B /P*P *! *M
Or for ProBoard, in PROCFG, under
Options->Paths->Extern.Chat, the following line can be
added:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /F /MR /N*# /B*B /P*P *! *D
This will allow you to break into chat mode by pressing
ALT-C.
┌─────────────────────────────────────────────────────┐
│ Tip: If a user has logged on with EMSI, │
│ RemoteAccess will default to its own │
│ split-screen EMSI chat mode. To override │
│ this, press SHIFT-ALT-C instead of just ALT-C. │
└─────────────────────────────────────────────────────┘
14
2. LightChat can be assigned to an ALT-FUNCTION key
combination in RACONFIG or PROCFG. In RACONFIG, under
Manager->AltFn keys, the following line can be added:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /F /MR /N*N /B*B /P*P *! *M
Or for ProBoard, in PROCFG, under Sysop Macros, the
following line can be added:
@C:\RA\LIGHTCHT\LIGHTCHT.EXE /F /MR /N*# /B*B /P*P *! *D
Assuming you defined this for ALT-F1, you can now
force a user into chat mode by pressing ALT-F1.
If you are using RemoteAccess, but have not yet registered, you
should use the second of these methods, as the first is a
registered-only feature.
2.3.2 Configuring Other BBS Software
Since the procedures involved for configuring LightChat with
other BBS software vary greatly depending on which you are
using, it is not possible to list them all here. We recommend
that you refer to your BBS software documentation, and look for
a section on 'external chat', or 'running external programs',
for specific details.
It is essential that your BBS software can create DOOR.SYS type
files for LightChat to run. If these are created in the
current directory when you load LightChat, then all you need do
is configure your BBS to have a menu option that loads
LightChat, using the following command line:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /MR
The /MR parameter makes LightChat randomly select a chat mode
to start in. It has no effect unless you have registered
LightChat.
This will load LightChat and start the paging action.
If the DOOR.SYS files are not created in the current directory,
then you will have to make your BBS software run a batch file
to load LightChat, and just before the above command line, you
should make the batch file change into the directory containing
the DOOR.SYS file.
15
You may also wish to configure your BBS software so that you
can break into chat with a user, without the paging process, if
such a facility exists within your BBS software. The way to do
this is to enter another command line in the 'External chat
command line', if your BBS software has this feature.
Alternatively, you may be able to configure a function key, for
example, that invokes a configurable command-line. Please
refer to your BBS software documentation for details of how to
achieve this.
The command line you should use to bypass the paging process
is:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /F /MR
You will now be able to jump straight into chat with the user,
using the appropriate key or key combination.
2.4 Configuring Your BBS Software For LightEdit
LightEdit is effectively a stand-alone external message editor, that
is activated simply by passing a single parameter (/E) to LightChat.
From the user's point of view, the program is completely separate,
but it has the advantage that you do not need to set up another
program to use it!
All LightEdit's settings are the same as those for LightChat's
internal message editor (see Section 3.5).
LightEdit is a QuickBBS-compatible message editor, which means it
makes use of the MSGTMP and MSGINF interface. These two files are
created by the BBS software to pass information such as the user's
name, recipient, subject, and existing message content (if the
message is a reply) to the editor.
As such, LightEdit REQUIRES the presence of AT LEAST the MSGINF file
to operate. If this file does not exist, LightEdit will run in
local test mode.
LightEdit will also make use of the DOOR.SYS and EXITINFO.BBS files
if they exist, but their presence is entirely optional.
2.4.1 Configuring RemoteAccess or ProBoard
LightEdit is extremely easy to set up with either RemoteAccess
or ProBoard.
If you have used AutoInstall, LCSETUP will have created a
suitable command line for you and placed it in the External
Message Editor slot in RACONFIG or PROCFG.
16
Otherwise, you will have to do this yourself. In RACONFIG,
under the Options menu, select 'Messages'. From this menu,
select the 'External Editor' option.
You should now enter the following command line:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /E *M
Or for ProBoard, in PROCFG, under Options->Paths->External
editor cmd., enter the following command line:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /E *D
The /E parameter tells LightChat to switch to "LightEdit" mode,
and act as an external message editor.
The *M parameter forces RemoteAccess to swap out of memory
before executing LightChat, allowing LightChat to use more
memory for itself.
From now on, any users that have the 'ANSI full screen editor'
enabled as one of their options, will be presented with
LightEdit when they enter or reply to a message on your system!
2.4.2 Configuring Other BBS Software
Since the procedures involved for configuring LightEdit with
other BBS software vary greatly depending on which you are
using, it is not possible to list them all here. We recommend
that you refer to your BBS software documentation, and look for
a section on 'external editor', or 'running external programs',
for specific details.
As a bare essential, your BBS software must be able to create
QuickBBS-compatible MSGINF and MSGTMP files that can be used by
LightEdit.
If your software can do this, then you will need to have your
BBS software load LightEdit as follows:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /E
The /E parameter tells LightChat to switch to "LightEdit" mode,
and act as an external message editor.
17
3 LCSETUP
LCSETUP is LightChat's interactive configuration/setup utility. It
uses a standard user interface, which should make using it as simple
as possible. Each menu option displays a line of context sensitive
help at the bottom of the screen which should be enough for most
users to understand what the various options mean. If you need more
detailed help, you can press F1 at any time from within the program,
to display the relevant section of this manual.
Using LCSETUP is fairly intuitive even for novices, but a full list
of keys is provided below:
Cursor Up/Cursor Left/Shift-Tab Move selection bar up in menu.
Cursor Down/Cursor Right/Tab Move selection bar down in menu.
Home Highlight first menu item.
End Highlight last menu item.
Return Select menu option/Edit item.
Escape Previous menu/Quit/Cancel edit.
ALT-Z Shell to DOS.
F1 Display context-sensitive help.
From within the help-browser (invoked by pressing F1 at any time),
you may use the following keys:
Cursor Up Move up one line.
Cursor Down Move down one line.
CTRL-PgUp/Home Move to start of manual.
CTRL-PgDn/End Move to end of manual.
PgUp Move one page up.
PgDn Move one page down.
Tab Jump to a specific page number.
F4 Search for some specified text.
Shift-F4 Jump to a specific section.
ALT-Z Shell to DOS.
Escape Exit help-browser.
3.1 System
This menu lets you configure all LightChat's system options, such as
names, paths, filenames, paging behaviour, auto-greetings, auto-
goodbyes, etc.
3.1.1 Names
This menu lets you configure the SysOp's and Co-SysOps' names,
and their associated 'chat keys'.
Get SysOp name from
Defines where LightChat should look for the SysOp's name.
Use "LightChat" for LightChat's configuration file, or
"RA" for the DOOR.SYS file.
18
SysOp's name
The SysOp's name. Only used when [Get SysOp name from] is
set to "LightChat".
Alternative name #1
Alternative SysOp name #1. Useful for a Co-SysOp.
Chat key
Key used to answer a page request using the name defined
in [Alternative name #1] above.
Alternative name #2
Alternative SysOp name #2. Useful for a Co-SysOp.
Chat key
Key used to answer a page request using the name defined
in [Alternative name #2] above.
Alternative name #3
Alternative SysOp name #3. Useful for a Co-SysOp.
Chat key
Key used to answer a page request using the name defined
in [Alternative name #3] above.
3.1.2 Paths
This menu lets you define the paths LightChat requires to
locate certain system files. AutoInstall automatically
configures these.
System
Path to your BBS system directory.
Example: C:\RA
Semaphore
Path to your semaphore directory, where LightChat should
create it's semaphore files, mainly for multi-node use.
Example: C:\SEMAPHOR
19
Page tunes
Path to your LightChat page tunes. All files in this
directory are assumed to be LightChat paging tunes, so
nothing else should reside here.
Example: C:\RA\LIGHTCHT\TUNES
Modules
Path to your SoundTracker modules. All files in this
directory are assumed to be sound modules (.MOD, .S3M,
etc.), so nothing else should reside here. Files from
this directory are played if you have configured LightChat
to use a sound card.
Example: C:\RA\LIGHTCHT\MODS
USERDOES
Path to your USERDOES directory, where LightChat will
create USERDOES.nnn files to describe LightChat actions.
This is sometimes the same as your semaphore directory, or
it can be somewhere else, such as your RemoteAccess system
directory.
Example: C:\RA
Textfiles
Path to your default text file directory. LightChat will
attempt to locate screens in the directory specified by
the LightChat language currently in use, but if the file
cannot be found there, this directory will be searched
next. Place any files in this directory which you do not
have language-specific equivalents for.
Example: C:\RA\SCREENS
3.1.3 Filenames
This menu lets you define various system filenames (such as log
file and exclude-list) as well as some configurable ANSI/ASCII
screens. AutoInstall will automatically adjust the paths to
these files.
20
System log
Full path and filename of the log file you wish LightChat
to log details to. This can be your normal RemoteAccess
log file, or a log file specifically for LightChat. You
may include the *N macro in this filename - *N will be
replaced by the node number LightChat is running on, which
is useful for multi-node systems that wish to keep node's
log files separate.
Example: C:\RA\NODE*N\RA.LOG
Chat log
Full path and filename of the file you wish LightChat to
capture chat to (when activated). You may include the *N
macro in this filename - *N will be replaced by the node
number LightChat is running on.
Example: C:\RA\LIGHTCHT\CHAT*N.LOG
Reason
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when LightChat prompts the user for a reason
to chat.
Example: REASON
Too short
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when the reason for chat string is less than
the minimum length required.
Example: TOOSHORT
Excludelist
Full path and filename of a file in which you can list
users that you do not wish to be paged by. The file is
just a plain text file with one name on each line, such as
this:
Fred Bloggs
Joe Smith
Andy Cap
Example: C:\RA\LIGHTCHT\TWITS.LST
21
Excl. user
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when someone listed in the [Excludelist] file
(see above) tries to page you.
Example: EXCLUDE
Paging
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when paging the SysOp.
Example: PAGING
SysOp busy
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when the SysOp aborts a page.
Example: BUSY
Chatting
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when the SysOp is already chatting to another
user.
Example: INCHAT
No answer
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when the SysOp does not answer a page.
Example: NOANSWER
Wrong time
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when a user attempts to page outside of the
defined hours.
Example: PAGETIME
Max. pages
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when a user exceeds the maximum number of
pages per call (defined by [Maximum pages]).
Example: MAXPAGE
22
Excl. warn
Filename (excluding extension) of a .ASC/.ANS file which
is displayed when a user exceeds the maximum number of
pages per call (defined by [Maximum pages]), and
AutoExclude has not been disabled.
Example: WARNING
3.1.4 Paging
This menu lets you configure all LightChat's paging options,
including page tunes, pager behaviour and display, reason for
chat, and paging hours.
3.1.4.1 General
This menu lets you define how LightChat should behave
under certain circumstances, and what type of pager to
use.
Type
This defines what sort of sound LightChat should make
when a user pages the SysOp. "Tune" refers to the
LightChat paging tunes found in your "Page tunes"
directory. "Module" refers to the SoundTracker
modules found in your "Modules" directory. "None"
means LightChat will page you silently. "Beep"
indicates that LightChat will produce simple beeps
whilst paging.
Sound card
If you have selected your pager type to "Module", you
can use this option to tell LightChat what type of
sound card you have. Select "Autodetect" to have
LightChat automatically detect your soundcard and
settings, or change this option to the type of card
you have in your system.
Mixing freq.
The mixing frequency of your sound card (slower
machines should use lower values; fast machines can
use high values for better quality sound).
DMA buffer
The size of the DMA buffer LightChat should use with
your sound card.
23
Volume
The volume your sound card should be set to before
playing sound modules.
Duration
Length of page (in seconds).
Maximum pages
This field defines how many times the user is allowed
to page during each call. It has two functions:
1. If [Auto-excl. pages] (see below) is set to zero,
and the user pages more times than this value, the
file defined in [Max. pages] will be displayed,
and the user will not be allowed to page again. If
you do not wish to set a maximum number of pages,
this field should be set to zero.
2. If [Auto-excl. pages] (see below) is not set to
zero, and the user pages more times than this
value, the file defined in [Excl. warn] will be
displayed, and the user will be allowed to page
again. This is, in effect, the number of pages
before the user should be warned about being
AutoExcluded. If you so not wish the user to be
warned before being AutoExcluded, this field
should be set to zero.
Auto-excl. pages
This field determines how many pages LightChat will
allow before a user is automatically added to the
excluded user list (defined in [Excludelist]). If
you do not wish users to be automatically excluded,
this field should be set to zero. This field is
ignored if you have not yet registered LightChat.
Busy action
This defines what action to take if the SysOp is
already chatting on another line and a user attempts
to page. "Show 'SysOp chatting' file" indicates that
the file defined in [Chatting] will be displayed.
"Page SysOp anyway" tells LightChat to ignore the
fact that the SysOp may already be busy, and pages
anyway (good for multi-tasking SysOp's!).
24
Excluded action
This defines what action to take if a user listed in
the [Excludelist] attempts to page the SysOp. "Show
'User excluded' file" indicates that the file defined
in [Excl. user] will be displayed. "Pretend to page
(silent)" pages the SysOp as usual, with the
exception of no sound being made (so the SysOp is
unlikely to respond to the page).
Create USERDOES?
This defines whether LightChat should create
USERDOES.nnn files in the [USERDOES] directory to
enable "Who is on-line?" type programs to display
what the user is doing. Valid options are "Yes" or
"No".
Remote beep?
This defines whether LightChat should send a beep to
the remote (user) terminal whilst paging. Valid
options are "Yes" or "No".
3.1.4.2 Display
This menu lets you configure how you would like the pager
to appear to the user.
Display type
Defines what type of character LightChat should use
for the page progress indicator. Valid options are
"Bar" or "Dots". "Dots" prints one '.' character
per second during paging, whereas "Bar" displays a
'bar-graph' indicating page progress, using the
settings below.
Bar length
If [Display type] is set to "Bar", this field
determines the length of the bar (in characters).
Bar position
If [Display type] is set to "Bar", this field
determines the position of the bar on the screen.
Empty colours
If [Display type] is set to "Bar", this colour
selector will determine what colour the empty page
bar will be displayed in.
25
Empty char.
This is the character to be used to display an 'empty'
page bar. It's colour is defined by the option above.
Full colours
If [Display type] is set to "Bar", this colour
selector will determine what colour the full page bar
will be displayed in.
Full char.
This is the character to be used to display a 'full'
page bar. It's colour is defined by the option above.
3.1.4.3 Hours
This menu allows you to define what times you are
available for paging during the week.
The days of the week are displayed on the left side
of the screen, and the hours of each day are
displayed along the top.
By moving the flashing cursor around the grid and
pressing Space, you can define whether or not you are
available for paging at certain times of the day.
Each day has 48 boxes, so that you can set your
availability in 1/2 hour intervals.
When you have registered LightChat, you will be able
to make use of it's paging history facility within
this screen. LightChat will record your users'
paging activity over time, and will display periods
of low (green), medium (yellow) and high (red)
demand.
3.1.4.4 Reason for chat
This menu lets you configure LightChat's 'reason for chat'
feature; whether it's active or inactive, and its
appearance on screen.
Ask for reason?
Defines whether LightChat should prompt the user for
a reason before attempting to page the SysOp. Valid
options are "Yes" or "No".
26
Minimum length
If [Ask for reason?] is set to "Yes", this field
defines the minimum number of characters allowed for
the user's reason for paging.
Maximum length
If [Ask for reason?] is set to "Yes", this field
defines the maximum number of characters allowed for
the user's reason for paging.
Position
If [Ask for reason?] is set to "Yes", this field
determines where the user enters their reason for
paging on the screen.
Colours
If [Ask for reason?] is set to "Yes", this colour
selector will determine what colour the reason for
paging text will be displayed in.
Empty character
This is the character to be used to display an
'empty' reason for chat field. It will be used to
show an 'empty' field at first, and also if Backspace
is pressed whilst editing the reason. It's colour is
defined by the option above.
3.1.5 General
This menu lets you configure general LightChat system options,
such as status bar colours, word-macro triggers, log style,
SimuType speed, and which user appears in which window.
3.1.5.1 Random ANSI effects
This menu lets you enable and disable a selection of
LightChat's animated ANSI effects that are used when
loading. LightChat (and LightEdit) will select one of the
enabled effects at random, or use a non-animated version
if all the effects are disabled.
Use Swipe?
Defines whether LightChat should use the 'Swipe'
effect when loading. This effect 'highlights' the
LightChat banner from left to right. Valid options
are "Yes" or "No".
27
Use Searchlight?
Defines whether LightChat should use the
'Searchlight' effect when loading. This effect
'lights up' the LightChat banner from left to right,
and back again. Valid options are "Yes" or "No".
Use Jump?
Defines whether LightChat should use the 'Jump'
effect when loading. This effect highlights each
letter in turn and makes them 'jump' up and down
again. Valid options are "Yes" or "No".
Use Collect?
Defines whether LightChat should use the 'Collect'
effect when loading. This effect makes each letter
in the LightChat banner drop in to place from the top
and right of the screen. Valid options are "Yes" or
"No".
Use Wacky?
Defines whether LightChat should use the 'Wacky'
effect when loading. This effect randomly changes
the colours and case of the letters in the LightChat
banner. Valid options are "Yes" or "No".
Word-macro triggers
Defines which characters typed will trigger word-macros
whilst in chat mode (e.g. "() +-=,.?!/*"). Note that the
RETURN key is always an active word-macro trigger.
Log style
Defines the LightChat log file format. Valid options are
"Expanded" or "Compact". The logging behaves in a similar
way to RemoteAccess logging.
Min. SimuType delay
Defines the minimum delay between SimuType'd characters
(for auto-greetings etc.) appearing on the screen (in
milliseconds). Altering this value helps customise your
simulated typing speed to fool users.
Max. SimuType delay
Defines the maximum delay between SimuType'd characters
(for auto-greetings etc.) appearing on the screen (in
milliseconds). Altering this value helps customise your
simulated typing speed to fool users.
28
SysOp window number
Defines which window the SysOp should appear in on the
local screen. Valid options are "1" or "2".
User window number
Defines which window the user should appear in on the
remote screen. Valid options are "1" or "2".
Auto chat capture?
Defines whether LightChat should automatically open the
chat capture file [Chat log] (defined in
System->Filenames), and log the SysOp's and user's type as
soon as chat mode is entered. Valid options are "Yes" or
"No".
Flash key-lights?
Defines whether LightChat should flash the keyboard lights
in time to the page tune (only applicable if Page type is
set to 'Tune'). We highly recommend that you set this
option to "No" if you are using a multitasker, otherwise
your typing in another window will be affected by Caps
Lock being toggled! Valid options are "Yes" or "No".
Status bar colours
This colour selector will determine what colour the SysOp
status bar appears as on the local screen.
Separator colours
This colour selector will determine what colour the
separators on the SysOp status bar appear as on the local
screen.
3.1.6 Strings
This menu will let you configure the auto greetings and auto
goodbyes.
3.1.6.1 Auto greetings
This menu lets you configure LightChat's auto greeting
feature, and allows you to define up to 5 greetings.
29
Once only?
Defines whether or not LightChat should use
'intelligent' auto greetings. If set to "Yes",
LightChat will only greet a particular user once
during the same call. If set to "No", LightChat will
greet the user every time they enter chat.
SimuType?
Defines whether the automatic greetings should be
displayed using SimuType (simulated typing). Valid
options are "Yes" or "No".
Selection
Defines how LightChat should select an automatic
greeting. "Timed (use defined hours)" means LightChat
will show the relevant greeting during the defined
hours (see below). "No auto greetings" means that no
automatic greetings will ever be displayed. "Always
use Greeting #1" means that LightChat will always
display the greeting defined in [Greeting #1] (see
below). "Random" means that LightChat will randomly
choose a greeting from the available list (see
below).
Greeting #1
Defines greeting string #1. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Greeting #1] will be displayed.
Greeting #2
Defines greeting string #2. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Greeting #2] will be displayed.
Greeting #3
Defines greeting string #3. This field can contain
data codes (see Section 5.1).
30
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Greeting #3] will be displayed.
Greeting #4
Defines greeting string #4. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Greeting #4] will be displayed.
Greeting #5
Defines greeting string #5. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Greeting #5] will be displayed.
3.1.6.2 Auto goodbyes
This menu lets you configure LightChat's auto goodbye
feature, and allows you to define up to 5 goodbyes.
SimuType?
Defines whether the automatic goodbyes should be
displayed using SimuType (simulated typing). Valid
options are "Yes" or "No".
Selection
Defines how LightChat should select an automatic
goodbye. "Timed (use defined hours)" means LightChat
will show the relevant goodbye during the defined
hours (see below). "No auto goodbyes" means that no
automatic goodbyes will ever be displayed. "Always
use Goodbye #1" means that LightChat will always
display the goodbye defined in [Goodbye #1] (see
below). "Random" means that LightChat will randomly
choose a goodbye from the available list (see below).
31
Goodbye #1
Defines goodbye string #1. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Goodbye #1] will be displayed.
Goodbye #2
Defines goodbye string #2. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Goodbye #2] will be displayed.
Goodbye #3
Defines goodbye string #3. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Goodbye #3] will be displayed.
Goodbye #4
Defines goodbye string #4. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Goodbye #4] will be displayed.
Goodbye #5
Defines goodbye string #5. This field can contain
data codes (see Section 5.1).
Hours
If [Selection] is set to "Timed (use defined hours)",
this option allows you to define the hours in which
[Goodbye #5] will be displayed.
32
3.2 Chat keys
This menu allows you configure all the LightChat key definitions,
and their associated functions. You can change all the pre-defined
keys, delete them, or add additional keys.
This gives you total control on how various keys activate the
different features of LightChat. Up to 100 keystrokes can be
defined.
No.
This allows you to select the key definition number you wish to
edit from a list. Keys 1-50 are for the SysOp's use, and 51-
100 are for the user. Press Return on this option to display a
list.
Key
Defines the key you wish to activate the function(s).
Functions
Defines the actual functions associated with a key defined
in [Key] (see above). A menu, displaying available actions,
will appear. Each key may perform one or more actions (up to a
certain limit), and ends with the "End command" function.
A pre-defined key will display the functions for that key. You
can change them at each step by moving the cursor to another
function and pressing Return. When you have no more actions
for the key to perform, select "End command".
The "Display some text" and "Execute a program" actions may
contain special codes (to display/use a user's details, such as
their name, node number, etc.).
Refer to the following sections for details:
Text display data codes: Section 5.1
Full explanation of all functions: Section 5.2
List of codes for external programs: Section 5.3
Notes
This allows you to define a short note or comment associated
with the currently selected key.
3.3 Word Macros
This menu allows you define various word macros. These macros
instruct LightChat to automatically replace various words or letter
combinations, making them ideal for abbreviations, emotions and
complicated phrases. Up to 50 word macros can be defined.
33
No.
This allows you to select the word macro number you wish to
edit from a list.
Find
This defines the string which LightChat should check for. This
field may contain spaces.
Replace
This defines the string which LightChat should use to replace
the [Find] string (see above) with. This field may contain
spaces.
Check case?
Defines whether the [Find] string (see above) should only be
replaced if the case of the letters matches exactly. Valid
options are "Yes" or "No".
SimuType?
Defines whether the [Replace] string (see above) should be
SimuTyped (use simulated typing). Valid options are "Yes" or
"No".
Available to
Defines who may use the word macro. "SysOp and user" means
that both the SysOp and the user can use the macro. "SysOp
only" means that only the SysOp can use the macro. "User only"
means that only the user can use the macro.
3.4 Chat Mode Manager
The Chat Mode Manager allows you to configure up to 255 different
chat modes. LightChat is distributed with some pre-configured modes
for you to try, but you can amend, delete, or add to them as you
wish.
When you first enter the Chat Mode Manager, you are placed in "View"
mode. The top left of the window will show the mode number
currently being displayed.
The following keys are available in View mode:
Return Edit chat mode currently
displayed. Chat Mode Manager will
enter "Edit" mode.
Escape Exit the Chat Mode Manager.
34
Ins Add a new chat mode. A new chat
mode will be created at the end of
the list, and Chat Mode Manager
will enter "Edit" mode.
Del Delete the chat mode currently
displayed. Note that you cannot
delete the ASCII Chat mode (Mode
1). Chat Mode Manager will prompt
you to confirm the deletion.
F1 Display context-sensitive help.
F2 Move chat mode to another slot.
Chat Mode Manager will display a
list of all the chat modes. Move
the highlighted bar to the
location you would like the mode
moved to, and press Return.
F3 Create a copy of the chat mode.
Chat Mode Manager will copy the
current chat mode to the end of
the list, and enter "Edit" mode.
F4 Search for a chat mode by name.
If an exact match cannot be found,
the closest match will be
displayed.
F5 Browse chat modes. A list of chat
modes will be displayed, along
with their status. Use the cursor
keys to navigate the list, and
press Return to jump to that chat
mode.
Cursor Up/Cursor Left/Shift-Tab Display previous chat mode.
Cursor Down/Cursor Right/Tab Display next chat mode.
Home Display first chat mode.
End Display last chat mode.
ALT-Z Shell to DOS.
3.4.1 Editing chat modes
Once you are in "Edit" mode, you can change all of the
characteristics of the chat mode. Press 'Escape' to exit
"Edit" mode and return to "View" mode. Chat Mode Manager will
ask you whether you wish to save any changes you have made.
35
The following options are available in "Edit" mode:
Name
Name given to this chat mode. This is only used for the
SysOp's benefit, so that different modes can easily be
identified.
Status
Defines whether this mode should be used by LightChat or
not. Setting a mode to "Inactive" is a useful way of
temporarily disabling it. When inactive, a mode cannot be
chosen at random, and will not be used when the SysOp
switches to the next active chat mode. However, it WILL
be used if the SysOp specifically requests that mode
number. Valid options are "Active" or "Inactive".
Screen file
Full path and filename to the .ANS file which is used for
this chat mode.
Example: HORIZONT.ANS
Clock type
This defines what type of clock should be used on the main
chat screen. Valid options are "13:00 (24hr)", "01:00p
(12hr)", "01:00pm (12hr)" or "13:00AM (12hr)".
Flash?
Defines whether the ":" in the clock should flash every
second. Valid options are "Yes" or "No".
Position
This field determines the position of the clock on the
screen.
Colours
This colour selector will determine what colour the clock
will be displayed in.
Date type
This defines what type of date should be used on the main
chat screen. Valid options are "30-01-96", "01-30-96",
"30 Jan 1996", "Jan 30 1996", "30 January 1996", "January
30 1996", "Monday 30 January 1996" or "Monday January 30
1996".
36
Position
This field determines the position of the date on the
screen.
Colours
This colour selector will determine what colour the date
will be displayed in.
Window 1 colours
This colour selector will determine what colour the text
that appears in window 1 will be displayed in.
Boundaries
This field determines the on-screen borders of the chat
window 1. The first co-ordinates are for the top left
corner, and the second ones are for the bottom right
corner.
Scroll lines
Defines the number of lines the text within a window
should scroll up when the cursor reaches the bottom.
Name position
This field determines the position of the window owner's
name on the screen.
Max. name len.
Defines the maximum length of the window owner's name
which will be displayed. If the actual name is longer
than this figure, the name will be truncated.
Line buffer
Defines the number of lines that LightChat should buffer
for this window. This is used for scrolling back to
previously typed text.
Windows 2 colours
This colour selector will determine what colour the text
that appears in window 2 will be displayed in.
Boundaries
This field determines the on-screen borders of the chat
window 2. The first co-ordinates are for the top left
corner, and the second ones are for the bottom right
corner.
37
Scroll lines
Defines the number of lines the text within a window
should scroll up when the cursor reaches the bottom.
Name position
This field determines the position of the window owner's
name on the screen.
Max. name len.
Defines the maximum length of the window owner's name
which will be displayed. If the actual name is longer
than this figure, the name will be truncated.
Line buffer
Defines the number of lines that LightChat should buffer
for this window. This is used for scrolling back to
previously typed text.
3.5 Language manager
The Language Manager allows you to configure up to 255 different
languages. LightChat is distributed with some pre-configured
languages for you to try, but you can amend, delete, or add to them
as you wish. Using the Language Manager, you can completely
customise all the text seen by the user within LightChat and
LightEdit. Using multiple languages, you can also support
international users on your BBS (multiple language support is only
available with RemoteAccess).
When you first enter the Language Manager, you are placed in "View"
mode. The top left of the window will show the language number
currently being displayed.
The following keys are available in View mode:
Return Edit language currently displayed.
Language Manager will enter "Edit"
mode.
Escape Exit the Language Manager.
Ins Add a new language. A new
language will be created at the
end of the list, and Language
Manager will enter "Edit" mode.
Del Delete the language currently
displayed. Language Manager will
prompt you to confirm the
deletion.
38
F1 Display context-sensitive help.
F2 Set the currently displayed
language to be the default
language. If a particular user
has no language set, or is using a
language that you have not
configured in LCSETUP, the default
language will be used instead.
F3 Create a copy of the language.
Language Manager will copy the
current language to the end of the
list, and enter "Edit" mode.
F4 Search for a language by name. If
an exact match cannot be found,
the closest match will be
displayed.
F5 Browse languages. A list of
languages will be displayed, along
with their status. Use the cursor
keys to navigate the list, and
press Return to jump to that
language.
Cursor Up/Cursor Left/Shift-Tab Display previous language.
Cursor Down/Cursor Right/Tab Display next language.
Home Display first language.
End Display last language.
ALT-Z Shell to DOS.
3.5.1 Editing languages
Once you are in "Edit" mode, you can change all of the
characteristics of the language. Press 'Escape' to exit "Edit"
mode and return to "View" mode. Language Manager will ask you
whether you wish to save any changes you have made.
39
The following options are available in "Edit" mode:
Name
Name given to this language. If you are using
RemoteAccess, the name given to the user's language is
checked in your RA configuration. LightChat then attempts
to find a match against the languages it has defined, and
if found, that language is used. If not, the default
language is used instead. It is therefore important to
name the languages exactly the same as those defined in
your RemoteAccess setup.
Status
Defines whether this language should be used by LightChat
or not. Setting a language to "Inactive" is a useful way of
temporarily disabling it. Valid options are "Active" or
"Inactive".
Language text
This option allows you to customise all the text used by
this language, including prompts, menus, colours, and
valid key responses. See Section 3.5.2 (next) for details
on customising a language.
Text path
Defines the path that text files for this language reside
in. This allows you to customise all LightChat's screens
for each individual language. If the screen cannot be
located in this directory, the default textfiles directory
is scanned next.
Filename
The full path and filename to the LightChat language
definition file for this language. This file contains all
the language content required by LightChat. When creating
a new language, specify the filename, and then select the
"Language text" option to customise the content.
3.5.2 Customising languages
After selecting the "Language text" option from the Language
Manager, you will be placed in the "Language Editor" and will
be able to edit the content of the selected language. The line
at the top of the editor displays the default text for the
currently highlighted line. This is especially useful if you
are translating a language file, as you can refer back to the
English translation.
40
The following keys are available in the Language Editor:
Return Edit current line. Change the text as
necessary. If the current line is a text
prompt that requires a response, you will
also be presented with the valid
keypresses, which can be changed.
Escape Exit the Language Editor. You will be
prompted to save any changes.
F1 Display context-sensitive help.
F2 Set the colour of the current line of text.
If no colour is selected (black on black),
the current text colour will be used.
F3 Copy the default text (shown at top) for
the currently highlighted line of text.
Default colours and key responses will also
be copied.
F4 Search for a line of text in this language.
If an exact match cannot be found, the
closest match will be displayed.
Cursor Up Move up through language text.
Cursor Down Move down through language text.
Page Up Move a page up at a time.
Page Down Move a page down at a time.
Home/Ctrl-Page Up Move to top of language text.
End/Ctrl-Page Down Move to end of language text.
ALT-Z Shell to DOS.
3.6 Message editor
This menu lets you configure options for LightChat's
message-to-SysOp feature, such as its appearance, behaviour, and the
conditions under which it can be used.
3.6.1 General
This menu allows you to configure general message-to-SysOp
options, such as the message base type, path, and the message
recipient.
41
Message type
Defines what type of message base LightChat should post a
message in. Valid options are "HMB" (Hudson message base)
or "JAM".
HMB board no./JAMbase path
This option changes depending on the setting of [Message
type] (see above). It defines the HMB board number (1-
200) or the path of a JAMbase in which the message to
SysOp should be posted. If defining a JAMbase path, you
should enter the full path and basename of the JAMbase,
without any extension.
Word-macros?
Defines whether LightChat's word-macros can be used in the
message editor. Valid options are "Yes" or "No".
Add tearline?
Defines whether LightChat should append a tearline to the
message to SysOp. Valid options are "Yes" or "No". If
you have not yet registered LightChat, a tearline will be
added to the message, regardless of the setting of this
option.
Msg. buffer
Defines the capacity of the message to SysOp (in number of
lines). The user will not be able to write any more when
this maximum has been reached.
Quote buffer
Defines the capacity of the quote window in LightEdit.
The user will not be able to quote any more of the
original message when this maximum has been reached.
Addressee
Defines whether the message should be addressed to the
current SysOp name (which may be the SysOp's, or a co-
SysOp's if they have answered the page), or to an
alternative name that you can define in [Other] (see
below). Valid options are "SysOp" or "Other".
Other name
If [Addressee] (see above) has been set to "Other", this
field determines the alternative name that the message
should be addressed to.
42
3.6.2 Conditions
This menu lets you configure the conditions under which
LightChat will ask the user if they wish to leave a message.
Excluded user
Defines whether LightChat should ask the user if they wish
to leave a message when they have been barred from paging
(i.e. their name appears in the file defined by
[Excludelist]). Valid options are "Yes" or "No".
Note: If you change this setting, you should also add or
remove the 'Leave message to SysOp?' question, as
applicable, from the screens defined in [Excl.
user].
Out of hours
Defines whether LightChat should ask the user if they wish
to leave a message when they have paged out of the defined
hours. Valid options are "Yes" or "No".
Note: If you change this setting, you should also add or
remove the 'Leave message to SysOp?' question, as
applicable, from the screens defined in [Wrong
time].
Unanswered page
Defines whether LightChat should ask the user if they wish
to leave a message when their page has not been answered.
Valid options are "Yes" or "No".
Note: If you change this setting, you should also add or
remove the 'Leave message to SysOp?' question, as
applicable, from the screens defined in [No answer].
SysOp abort
Defines whether LightChat should ask the user if they wish
to leave a message when the SysOp has aborted the page by
pressing Escape. Valid options are "Yes" or "No".
Note: If you change this setting, you should also add or
remove the 'Leave message to SysOp?' question, as
applicable, from the screens defined in [SysOp
busy].
User abort
Defines whether LightChat should ask the user if they wish
to leave a message when the user has aborted the page by
pressing CTRL-K. Valid options are "Yes" or "No".
43
SysOp chatting
Defines whether LightChat should ask the user if they wish
to leave a message when the SysOp is chatting to a user on
another node. Valid options are "Yes" or "No".
Note: If you change this setting, you should also add or
remove the 'Leave message to SysOp?' question, as
applicable, from the screens defined in [SysOp
chatting].
3.6.3 Screen
This menu allows you to configure the appearance of the message
editing screen.
Screen file
Filename (including extension) to the .ANS file which is
used for the message editor screen.
Note: No screen is provided for ASCII users.
Example: EDITOR3D.ANS
Window bounds
This field determines the on-screen borders of the message
editing window. The first co-ordinates are for the top
left corner, and the second ones are for the bottom right
corner.
Scroll lines
Defines the number of lines the text within a window
should scroll up when the cursor reaches the bottom.
To: position
This field determines the position of the user's name on
the screen.
Subject: position
This field determines the position of the message subject
on the screen.
Maximum length
Defines the maximum allowed length of the message subject.
This should be set to the maximum amount of space you have
allowed in your configurable ANSI screen for the message
subject. LightChat will not allow the user to enter a
subject longer than this value.
44
Quote window bounds
This field determines the on-screen borders of the message
quoting window. The first co-ordinates are for the top
left corner, and the second ones are for the bottom right
corner.
Scroll lines
Defines the number of lines the text within the quote
window should scroll up when the cursor reaches the
bottom.
Text colours
This colour selector will determine what colour the
quote-window text will be displayed in.
Header colours
This colour selector will determine what colour the text
in the message header (user's name, and message subject)
will be displayed in.
Message colours
This colour selector will determine what colour the
message text will be displayed in.
LightBar colours
This colour selector will determine the colour of
deselected options in a LightBar menu. LightBars are used
when asking the user if they wish to leave a message, and
when displaying the menu from the message editor.
Highlighted
This colour selector will determine the colour of selected
(highlighted) options in a LightBar menu.
Clock type
This defines what type of clock should be used on message
editing screen. Valid options are "12:00 (24hr)", "12:00a
(12hr)", "12:00am (12hr)" or "12:00AM (12hr)".
Flash?
Defines whether the ":" in the clock should flash every
second. Valid options are "Yes" or "No".
45
Position
This field determines the position of the clock on the
screen.
Colours
This colour selector will determine what colour the clock
will be displayed in.
3.6.4 Editor keys
This menu allows you configure all the LightEdit key
definitions, and their associated functions. You can change
all the pre-defined keys, delete them, or add additional keys.
This gives you total control on how various keys activate the
different features of LightEdit. Up to 50 keystrokes can be
defined.
No.
This allows you to select the key definition number you
wish to edit from a list. Press Return on this option to
display a list.
Key
Defines the key you wish to activate the function(s).
Functions
Defines the actual functions associated with a key defined
in [Key] (see above). A menu, displaying available
actions, will appear. Each key may perform one or more
actions (up to a certain limit), and ends with the "End
command" function.
A pre-defined key will display the functions for that key.
You can change them at each step by moving the cursor to
another function and pressing Return. When you have no
more actions for the key to perform, select "End command".
The "Display some text" and "Execute a program" actions
may contain special codes (to display/use a user's
details, such as their name, node number, etc.).
Refer to the following sections for details:
Text display data codes: Section 5.1
Full explanation of all functions: Section 5.2
List of codes for external programs: Section 5.3
46
Notes
This allows you to define a short note or comment
associated with the currently selected key.
3.7 Registration
This menu allows you to enter your registration name and key if
you have registered, which will enable you to gain access to
the registered-only features of LightChat.
Registered to
This field should contain your personal LightChat registration
string, exactly as it was given to you by Lightning Systems.
Leave blank if you have not yet registered LightChat.
Key
This field should contain your personal LightChat registration
key number. Leave blank if you have not yet registered
LightChat.
3.8 Information
This option will display some general information about LightChat,
including version number, copyright, and the compiler used.
3.9 Exit to DOS
This option will exit LCSETUP and return to DOS. Before exiting,
LCSETUP will check if you have made any changes, and if so, ask you
whether you wish to save them.
If you wish to temporarily shell to DOS at any time whilst using
LCSETUP, you may do so by pressing ALT-Z.
47
4 LIGHTCHT
LIGHTCHT.EXE is the main chat program itself, that will be loaded
when you invoke LightChat or a user pages you.
4.1 Command line parameters
LIGHTCHT.EXE accepts several parameters:
/L Run LightChat in local test mode.
/E Switch LightChat into "LightEdit" mode.
/F Jumps straight into chat without paging.
/H Forces LightChat to leave the fossil driver "hot".
/A1 Use name defined in [Alternative name #1].
/A2 Use name defined in [Alternative name #2].
/A3 Use name defined in [Alternative name #3].
/Mm Forces LightChat into ASCII Chat Mode 'm'.
/MR Selects an ANSI Chat Mode at random (registered version
only). This parameter is ignored if the user's terminal
does not support ANSI.
/Nn Specifies that LightChat is running on Node 'n'.
/Pp Specifies that LightChat should use port 'p'.
/Bb Specifies that the caller is logged on at 'b' baud rate.
The /N, /P, and /B parameters are entirely optional, but are
REQUIRED if you wish LightChat's intelligent "logon" mode (see
Section 4.2.2) to function correctly.
The /A parameter is used to set LightChat to use a name other than
the SysOp's. This parameter is overridden if one of the alternative
SysOp name keys is used to answer a page.
For example, if you wished to go straight into a random chat mode,
using the name defined in [Alternative name #1], you might use the
following command line from RemoteAccess:
C:\RA\LIGHTCHT\LIGHTCHT.EXE /F /A1 /MR *! *M
The *! and *M parameters are interpreted by RemoteAccess, and are
not passed to LightChat - see your RemoteAccess documentation for
more details.
48
4.2 Operation
4.2.1 Paging
During the paging process, you will hear a beep or a tune
(depending on your configuration), and will see some form of
progress, either as dots or in the form of a bar-graph. During
this period, you may decide to abort the page, answer it, or
ignore it. If the user has been prompted for a reason for
chat, that reason will be shown along with their name, on the
status bar. You may use the 'rotate status bar' macro keys to
find out further details about the user before deciding how to
deal with the page request.
Aborting:
To abort the page, simply press Escape. The user will
then be shown the screen defined in [SysOp busy].
Answering:
If you wish to use a name other than the SysOp's, you
should press the associated 'chat key' you have defined
for that name in System->Names.
Otherwise, you should press any key (other than Escape),
and you will enter chat mode, with the SysOp's name (or an
alternative name, if one was passed on the command line).
Ignoring:
You may wish to simply ignore the user's page, in which
case, they are shown the screen defined in [No answer],
and may be offered the opportunity of leaving a message
instead, if you have configured LightChat to do so.
LightChat has a 'silence' key that you can use when you do not
want to be disturbed; if Scroll-Lock is on during the paging
process, no sound will be made.
4.2.2 Intelligent "logon" mode
This is a special feature unique amongst RemoteAccess chat
programs.
With other programs, if you break into chat with a user who
hasn't yet entered their name, or is in the middle of the new
user procedure, one of two things will usually happen:
1) The program will report that EXITINFO.BBS is missing, and
not run.
2) The program will run, but have the previous caller's name
and details!
49
There is a reasonable explanation for this behaviour;
RemoteAccess does not create a DOOR.SYS and EXITINFO.BBS file
for the user until they have fully logged on. The problem is
that there can be an OLD DOOR.SYS file present, and the chat
program can use the details from there instead. This is simply
frustrating, rather than disastrous, but of course, it can mean
that the chat program thinks the user has ANSI capabilities
when in fact they do not.
LightChat, however, has the capability of recognising when a
user is still logging on, and will behave accordingly. If it
detects that a user has not yet logged on properly, it will try
and find as much information about the user from alternative
sources. For instance, if the user has entered their name, and
is in the middle of the new user procedure, LightChat will be
able to use their name, perform an AutoGreeting if configured,
and will assume ASCII mode.
If they have not even entered their name when you break into
chat, LightChat will suppress AutoGreetings and enter ASCII
mode. You will see "Someone from Somewhere" on the status bar,
as the user has not yet entered a name or location.
IMPORTANT NOTE: To make use of this feature, you MUST use the
/P, /N, and /B parameters (see Section 4.1), which "logon" mode
uses to ascertain whether or not DOOR.SYS is a reliable source
of information.
4.2.3 Using AutoExclude
AutoExclude is a facility (available only if you have
registered LightChat) which enables you to automatically bar
users from paging you by adding their names to the 'exclude'
list; careless configuration can lead to unexpected results and
baffled users.
The [Maximum pages] and [Auto-excl. pages] fields in
System->Paging->General are closely linked. The following
table illustrates the relationship between them.
50
┌───────────────┬──────────────────┬───────────────────────────┐
│ Maximum pages │ Auto-excl. pages │ Action │
├───────────────┼──────────────────┼───────────────────────────┤
│ 0 │ 0 │ User can page the SysOp │
│ │ │ indefinitely. │
├───────────────┼──────────────────┼───────────────────────────┤
│ 3 │ 0 │ User can page the SysOp 3 │
│ │ │ times. If they page again,│
│ │ │ the file [Max. pages] │
│ │ │ (defined in │
│ │ │ System->Filenames) is │
│ │ │ shown. │
├───────────────┼──────────────────┼───────────────────────────┤
│ 0 │ 5 │ On the 5th page, the user │
│ │ │ will be automatically │
│ │ │ added to the exclude list │
│ │ │ (defined in │
│ │ │ System->Filenames) without│
│ │ │ any warning. │
├───────────────┼──────────────────┼───────────────────────────┤
│ 2 │ 5 │ After 2 pages, the user │
│ │ │ will be shown the file │
│ │ │ [Excl. warn] (defined in │
│ │ │ System->Filenames), but │
│ │ │ will still be allowed to │
│ │ │ page the SysOp. On the │
│ │ │ 5th page, the user will be│
│ │ │ automatically added to the│
│ │ │ exclude list (defined in │
│ │ │ System->Filenames). │
└───────────────┴──────────────────┴───────────────────────────┘
4.2.4 Customising screens
One of the major advantages LightChat has over its competitors
is that, once registered, all its screens are completely
configurable (when unregistered, you cannot customise the
reason for chat screen), so you are not forced to have the
program and author's name all over each screen, as is often the
case with other programs.
LightChat will always attempt to display a custom screen if one
is defined, but for every customisable screen there is some
plain text that will be shown instead, if no screen is defined
or for some reason the screen cannot be displayed.
When designing your own screens, remember that you might want
to create two versions, one in ANSI (ending in .ANS), and the
other in ASCII (ending in .ASC).
You should also remember to avoid using the 80th column and the
2 bottom rows (rows 24-25) of the screen, as these are liable
to make the screen scroll on remote terminals due to status
bars etc.
51
If you are using TheDraw to design your screens, it is best,
though not essential, to save the screens in 'animation mode'.
You should pay particular attention to the Message Editor
configuration when designing certain screens, as the conditions
you have set in Message Editor->Conditions will affect what you
need to put in some of the screens:
When LightChat asks the user if they wish to leave a message,
it only displays the question itself if no screen was defined
or the screen could not be found. For instance, if you have
configured LightChat to allow the user to leave a message when
no-one answers the page, you should have an appropriate
question in [No answer] (defined in System->Filenames).
LightChat will wait for 'y', 'n', or Return to be pressed after
showing this screen, so if you haven't asked the question in
the appropriate screen, it will be confusing for the user.
Remember that if you change the conditions under which
LightChat will allow the user to leave a message, you should
also change the appropriate screen.
4.2.5 Default Operation and Keys
Unlike many programs, LightChat's operation is almost totally
configurable, right down to the behaviour of individual
keypresses!
Of course, you may not want to have to configure so many
things, so LightChat is distributed with a default
configuration file and key-definition file. During the
beta-testing process, these defaults have been changed
regularly to make them as intuitive and 'ready-to-run' as
possible.
Everything is already configured for you, so if you don't have
the time, or are happy with the way LightChat works, then you
need never worry about changing anything. On the other hand,
the option is always there to customise as little or as much of
LightChat as you like.
For your convenience, the default keys and their functions for
LightChat are listed below:
Key: SysOp: User: Action:
───────────────────────────────────────────────────────────────
Backspace Yes Yes Delete character to the left.
Enter Yes Yes New line.
Delete Yes Yes Delete character to the right.
Home Yes Yes Go to start of line.
52
End Yes Yes Go to end of line.
Left Yes Yes Left one character.
Right Yes Yes Right one character.
Up Yes Yes Up one line.
Down Yes Yes Down one line.
PgUp Yes Yes Up one page.
PgDn Yes Yes Down one page.
Insert Yes Yes Toggle insert/overtype mode.
Control-W Yes Yes Clear window.
Control-O Yes No Clear other window.
Control-Y Yes Yes Delete line.
Control-G Yes Yes Beep.
Control-R Yes Yes Redraw screen.
Alt-Z/Alt-J Yes No Shell to DOS.
F1 Yes No Prompt for a chat mode.
F2 Yes Yes Switch to chat mode 2.
F3 Yes Yes Switch to chat mode 3.
F4 Yes Yes Switch to chat mode 4.
Alt-N Yes No Switch to next active mode.
Escape Yes Yes Exit LightChat.
Control-S Yes Yes Swap to other window.
Control-F Yes No Freeze user input.
Alt-H Yes No Hang-up user.
Alt-L Yes No Lockout user.
Alt-E Yes No Edit user's details.
Alt-T Yes No Sample execute-program command.
Transmits a file (REGISTER.TXT)
to the user using DSZ.COM.
Alt-C Yes No Loads LCSETUP.
53
Control-Left Yes No Rotate status bar left.
Control-Right Yes No Rotate status bar right.
Control-L Yes No Log chat buffer to file.
F5 Yes No (Sample macro #1) - Types
message to user and freezes
them.
F6 Yes No (Sample macro #2) - Types
message to user.
───────────────────────────────────────────────────────────────
Additionally, there is a separate set of key-definitions for
LightEdit, the built-in message editor. These keys are the
same when LightEdit is working in stand-alone mode as they are
when working after a failed page request.
For your convenience, the default keys and their functions for
LightEdit are listed below:
Key: Action:
───────────────────────────────────────────────────────────────
Backspace Delete character to the left.
Enter New line.
Delete Delete character to the right.
Home Go to start of line.
End Go to end of line.
Left Left one character.
Right Right one character.
Up Up one line.
Down Down one line.
PgUp Up one page.
PgDn Down one page.
Insert Toggle insert/overtype mode.
Control-Y Delete line.
Control-R Redraw screen.
54
Control-Q Switch between main message
editing window and quote
window.
Alt-Z/Alt-J Shell to DOS.
Escape Display message menu.
Alt-S/Control-S/Control-Z Save message immediately.
Control-F Freeze user input.
Alt-H Hang-up user.
Alt-L Lockout user.
Control-Left Rotate status bar left.
Control-Right Rotate status bar right.
───────────────────────────────────────────────────────────────
55
5 Appendices
5.1 Data Codes
Data codes are provided in LightChat to allow you to include
variable information in screens, system messages etc., such as the
user's name and the system node number.
A data code consists of Ctrl-K (ASCII 11) followed by one of the
following letters:
a User's first name.
b User's surname.
c Node number user is on.
d User's location.
e Full name of other user SysOp is chatting to.
f Node number other user is on.
g Other user's location.
Note: e, f and g are only set if the SysOp is already chatting to
another user.
n New line (CR, LF).
Two other data codes are available that do not need to be preceded
by Ctrl-K. These are:
Ctrl-A (ASCII 1) Waits for the ENTER key to be pressed.
Ctrl-W (ASCII 23) Pauses for 1 second.
These two codes are the same as those used by RemoteAccess.
Note: To enter data codes into LCSETUP, it is necessary to enter a
literal character. This is achieved by pressing CTRL-P before
the character you wish to enter.
Example #1: (entering code to show user's first name)
Type CTRL-P followed by CTRL-K followed by 'a'. The characters 'a'
should have appeared.
Example #2: (entering the 'wait for ENTER to be pressed' code)
Type CTRL-P followed by CTRL-A. The character '' should have
appeared.
56
5.2 Key functions
All of LightChat's in-chat features are accessed through
configurable key definitions, enabling you to group text and/or data
codes with one or more actions, assign them to a key of your choice,
and specify whether or not they may be used by the user. All of the
available actions assignable to keys are explained here:
Description: Purpose:
────────────────────────────────────────────────────────────────────
Backspace one char. Deletes one character to the left of the
cursor, or moves to the line above if used
at the start of a line.
Insert new line Inserts a new line at the current cursor
position.
Delete char. to right Deletes one character to the right of the
cursor.
Jump to start of line Moves the cursor to the start of the
current line.
Jump to end of line Moves the cursor to the end of the current
line.
Move left one char. Moves the cursor one character to the
left.
Move right one char. Moves the cursor one character to the
right.
Move up one line Moves the cursor up one line, scrolling if
necessary.
Move down one line Moves the cursor down one line, scrolling
if necessary.
Move up one page Scrolls the screen up one whole page
length.
Move down one page Scrolls the screen down one whole page
length.
Clear own window Clears the window you are currently in.
This command adds a new line to the end of
the chat buffer if necessary. Not
available in message editor.
Clear other window Clears the window the other user is
currently in. This command adds a new
line to the end of the chat buffer if
necessary. Not available in message
editor.
57
Delete current line Deletes an entire line in the current
window, pulling text from below up if
necessary.
Beep Sends a beep to the remote terminal and
makes a sound on the local machine. Not
available in message editor.
Display some text Displays some text (that you specify) in
the current window.
Redraw screen Clears and redraws the screen.
Insert/Overtype mode Switches between insert and overtype
editing mode.
Save message Saves the message immediately and exits
LightEdit. Not available in chat modes.
Shell to DOS Sends configurable message to user
(defined by language), attempts to swap
LightChat out to EMS, XMS or Disk, and
invokes a temporary DOS session. On
return, another configurable message is
sent to the user (to say you have
returned, for example). This command can
only be invoked by the SysOp.
Execute a program Executes an external program that you
specify. Special codes can be inserted in
the command line to pass the user's name,
baudrate, etc. These are listed in
Section 5.3 of this manual.
Display menu Displays the LightEdit menu, allowing the
user to change the subject, abort or save
the message.
Change chat mode Switches chat mode. Enter '0' if you
would like LightChat to prompt you for a
mode number at the time you press the key.
Otherwise, enter the mode number (in the
range 1-255).
Next chat mode Switches to the next active chat mode.
Exit LightChat Exits LightChat, after issuing auto
goodbye, if active. If unregistered, this
command can only be invoked by the SysOp.
Swap to other window Switches to other chat window. If this
command is used a second time, it switches
back to the original chat window. Not
available in message editor.
58
Switch to quote window Switches between the main editing window
and the quote window (and vice versa).
Freeze user input Temporarily 'freezes' user by ignoring
anything typed by them. If this command
is used a second time, the user is then
'unfrozen'. This command can only be
invoked by the SysOp.
Disconnect user Disconnects the user directly by hanging
up the modem.
Lock out user Sets the user's security level to zero,
then disconnects them as above.
Edit user's details Sends configurable message to user
(defined by language), enters LightChat's
internal user editor, then sends another
configurable message upon return. The user
editor is only available if EXITINFO.BBS
was found when LightChat loaded. This
command can only be invoked by the SysOp.
Not available in message editor.
Toggle chat log on/off Opens the chat capture file (defined in
System->Filenames), and logs user's typing
from start of chat buffer until capture
file is closed (achieved by using this
macro a second time). Not available in
message editor.
Rotate status bar left 'Rotates' the status bar left, to show
extended information about the user.
Extended information is only available if
EXITINFO.BBS was found when LightChat
loaded. This command can only be invoked
by the SysOp.
Rotate status bar right 'Rotates' the status bar right, to show
extended information about the user.
Extended information is only available if
EXITINFO.BBS was found when LightChat
loaded. This command can only be invoked
by the SysOp.
End command Select this to specify that no more
actions are to be performed for this key.
────────────────────────────────────────────────────────────────────
59
5.3 Embedded program codes
LightChat and LightEdit can both execute external programs, and it
is often useful to pass certain details about the user or their
connection to these programs.
LightChat achieves this by embedding special codes in the command
line you specify to run the external program. The codes have been
designed to work in a similar way to those used by RemoteAccess.
Below is a list of supported codes.
*B is replaced by the user's baudrate.
*F is replaced by the user's first name.
*H specifies that LightChat should leave the fossil driver 'hot'
before loading the program (fossil drivers are normally
deactivated first).
*G is replaced by the user's graphics setting
(0=ASCII, 1=ANSI)
*L is replaced by the user's last name.
*N is replaced by the user's node number.
*P is replaced by the user's port number.
Note that LightChat will always attempt to swap out before loading
an external program.
60
5.4 Errorlevels
LightChat and LightEdit return certain errorlevels indicating the
user's behaviour, system errors, etc.
A list of the errorlevels and their meaning is provided below:
Errorlevel Meaning
0 Normal exit, no error.
1 Aborted message (LightEdit).
2 User out of time (LightEdit).
3 Insufficient memory to run LightChat.
4 No fossil driver was loaded.
5 Configuration file not found; run LCSETUP.
6 Corrupt configuration file.
7 Command macro file not found.
8 Corrupt command macro file.
9 New (unrecognised) configuration file.
10 Old configuration file; run LCSETUP to import.
11 Corrupt database file; LIGHTCHT.UDB needs deleting.
12 Carrier lost.
13 Error writing message to messagebase.
14 Error opening MSGINF file (LightEdit).
15 Chat mode definition file not found.
16 Invalid chat mode definition file.
17 Language definition file not found.
18 Invalid language definition file.
19 Error opening language data file.
20 Invalid language data file.
21 Insufficient memory to load language data file.
22 Corrupt paging history file; LIGHTCHT.HST needs deleting.
23 Error initialising soundcard.
23-27 Reserved for future use.
28 Beta release has expired (beta versions only).
29 Invalid LightChat beta authorisation (beta versions only).
30 Excluded user was refused paging access.
31 User had exceeded the maximum number of pages per call.
32 User tried to page out of defined hours.
33 Reason for chat was too short.
34 The page was not answered.
35 User aborted the page.
36 SysOp aborted the page.
37 User was informed that the SysOp was chatting to another user.
38 SysOp disconnected the user.
39 SysOp locked out the user.
40 User left a message.
61
6 Credits
* LightChat and the LCSETUP configuration utility were developed by
David McGarry.
* LightChat uses the SPAWNO swapping routines, written by Ralf
Brown.
* LightChat distribution, registration and support services are
provided by Marcel Cook.
* Testing, evaluation and suggestions are provided by the Lightning
Systems beta team.
Thanks to: Marcel Cook, Michael Rallings, Adrian Thomas, Mike
Ehlert, Frank Schittek, Peter Seingier, Karl-Heinz
Jung, Steve Smith, Debbie Whitley, Bernd Herbst,
Thomas Sahlmann, John Kuhns, Phil Dowling, Christoph
Rasim
* All executables and documentation contained in the LightChat
distribution archive are Copyright (C) 1994-1996 Lightning
Systems; All rights reserved.
* All other products mentioned are copyrighted material and/or
trademarks of their respective owners.
62
7 Support and Information
If you need help, information or technical support, please contact
us by using one of the methods listed below, or contact your nearest
support site (see ORDERING.TXT for details):
Post : Lightning Systems
PO Box 123
CAMBRIDGE
CB4 3UL
UNITED KINGDOM
BBS : Lightning BBS, 44-1223-564061
FidoNet : Marcel Cook, 2:2504/100
E-mail : sales@lightning.co.uk
support@lightning.co.uk
WWW : http://www.lightning.co.uk
CIS : 100545,3045
63